home *** CD-ROM | disk | FTP | other *** search
/ TEKNO 1998 June / TEKNO 6-1998.iso / amiga / amiamp21.lha / AmigaAMP / AmigaAMP.liesmich < prev    next >
Text File  |  1998-07-08  |  17KB  |  420 lines
  1. Short:    MPEG audio player with GUI (68k/PPC)
  2. Uploader: Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  3. Author:   Thomas Wenzel (wenzel@unixserv.rz.fh-hannover.de)
  4. Type:     mus/play
  5. Version:  2.1a
  6.  
  7. Homepage
  8. --------
  9. http://amigaamp.amiga-software.com
  10.  
  11.  
  12. Einfⁿhrung
  13. ----------
  14. AmigaAMP ist ein MPEG Audio Player mit grafischer BenutzeroberflΣche.
  15. Zur Dekodierung wird auf dem 68k-Prozessor die mpega.library verwendet,
  16. die PPC-Version basiert auf dem amp Dekoder. Die Soundausgabe erfolgt
  17. ⁿber das AHI Audio System. Dieses Programm ist KEINE neue OberflΣche
  18. fⁿr CLI basierte Player sondern ein eigenstΣndiges Produkt.
  19. Sollten Probleme mit AHI, der AsyncIO.library oder der mpega.library
  20. auftreten, bitte ich jedoch darum, die jeweiligen Autoren zu kontaktieren,
  21. da ich hier ohnehin nicht helfen k÷nnte.
  22.  
  23.  
  24. Ben÷tigt werden:
  25. ----------------
  26. AmigaOS 3.0 oder h÷her
  27. 68030-50MHz Prozessor oder besser
  28. mpega.library    (Aminet:util/libs/mpega_library.lha)
  29. asyncio.library  (Aminet:dev/c/AsyncIO.lha)
  30. AHI audio system (Aminet:mus/misc/ahiusr.lha)
  31.  
  32.  
  33. Empfohlen
  34. ---------
  35. PowerUP und ppc.library v46
  36. AmigaOS 3.1 (OS3.1 UND PowerUp v46 werden fⁿr den Spectrum Analyzer ben÷tigt!)
  37.  
  38.  
  39. Besonderheiten
  40. --------------
  41.  - FREEWARE!  Keine Beta, keine Requester, keine beschrΣnkte Laufzeit!
  42.  - GadTools basiertes, fontsensitives Interface
  43.  - Alternativ dazu ein WinAMP kompatibles GUI
  44.  - Workbench Applikation (Drag'nDrop M÷glichkeit fⁿr Daten-Icons)
  45.  - sehr leicht konfigurierbar
  46.  - AHI Device Zugriff (der AHI Default Modus wird automatisch unterstⁿtzt)
  47.  - PPC (PowerUP) Unterstⁿtzung
  48.  - ID3 Tag Editor (Interpret, Titel, Album, etc.)
  49.  
  50. EinschrΣnkungen
  51. ---------------
  52.  - Die PPC-Version unterstⁿtzt noch kein MPEG2.5, ich arbeite dran
  53.  - Lediglich einfache Levelmeter in der 68k Version
  54.  - Keine Echtzeit Spektrometer mit AmigaOS 3.0 -- nix zu machen!
  55.  - Keine Echtzeit Spektrometer beim abspielen von MP2 -- noch nicht
  56.  
  57.  
  58. Entwicklungsgeschichte
  59. ----------------------
  60. v2.1a - Aktualisierte Dokumentation und Executable um deutlich zu machen,
  61.         da▀ ppc.library V46 ben÷tigt wird
  62.       - Bitte daran denken, mittels Prefs/PCDT AmigaAMP zu den V43
  63.         kompatiblen Programmen hinzuzufⁿgen (nur bei cgfx)
  64.  
  65. v2.1  - Einstellbare Abspielpuffergr÷▀e (sollte viele Probleme beseitigen!)
  66.       - Truecolor skins werden jetzt auf Truecolor Screens nicht mehr
  67.         gedithert.
  68.       - Skin Bilder k÷nnen jede beliebige Extension haben, solange der
  69.         Name stimmt.
  70.       - Fehler bei 48 kHz MPEGs im PPC Loader behoben
  71.       - Asynchroner Dateirequester
  72.       - Skins k÷nnen jederzeit nachgeladen werden.
  73.       - Automatische Wiedergabe nach dem ÷ffnen einer Datei, falls vorher
  74.         ebenfalls Wiedergabe aktiv war
  75.       - Einige Skin Positionen korrigiert
  76.       - Visualisierung auch in der 68k Version (Aussteuerungsanzeige)
  77.       - MaxFreq funktioniert endlich
  78.  
  79. v2.0  - Sehr viele ─nderungen die einen Sprung der Versionsnummer wert sind :-)
  80.       - Position des Genre Listview Gadgets korrigiert
  81.       - Fehler beim Abspielen von Mono- oder 22.05 kHz Dateien beseitigt
  82.       - Digitale LautstΣrkeregelung
  83.       - AREXX Interface (siehe AREXX.readme -- nur in englisch)
  84.       - Automatische Erkennung ob bereits ein anderer AmigaAMP Task lΣuft
  85.       - Alphabetisch sortierte Playliste (noch nicht editierbar)
  86.       - Konfigurierbare Puffergr÷▀e
  87.       - OberflΣche, die so aussieht wie WinAMP (siehe unten)
  88.       - FontsensitivitΣt der alten OberflΣche verbessert
  89.       - TagInfo wird gepuffert und erst beim schlie▀en der Datei geschrieben
  90.  
  91. v1.1  - In AmigaAMP umbenannt
  92.       - PPC Version
  93.       - ID3 Tag Editor
  94.       - Kommandozeilenunterstⁿtzung
  95.  
  96. v1.0  - Erste Ver÷ffentlichung, die noch MPEGAHI hie▀
  97.  
  98. Einfⁿhrung / Konfiguration
  99. --------------------------
  100. Wichtig! Eine korrekt installierte AHI Konfiguration ist Grundvoraussetzung
  101. fⁿr ein Funktionieren von AmigaAMP. Ohne korrekte AHI Installation wird
  102. der Klang wahrscheinlich ziemlich schlecht sein...
  103.  
  104. Starten Sie zunΣchst das AHI Setup Programm in Ihrem Prefs-Verzeichnis.
  105. WΣhlen Sie eins der Units 0 bis 3 (nicht das Music Unit). Wenn Sie noch kein
  106. Unit anderweitig verwenden, empfehle ich, Unit 0 einzustellen.
  107.  
  108. WΣhlen Sie einen der "Fast Stereo++" AudioModes aus, der sich mit der 
  109. von Ihnen verwendeten Soundkarte vertrΣgt. Fⁿr die Prelude empfehle ich
  110. die Verwendung des "Prelude:Fast 16 bit stereo++ realtime" Modus.
  111.  
  112. Nun sollten Sie in Erfahrung bringen, in welcher Samplingrate die meisten
  113. Ihrer MPEG Files kodiert sind. Normalerweise wird dies 44100Hz sein, da
  114. dies die Standard CD Rate ist. Wenn Sie einen langsamen Prozessor haben
  115. und Sie AmigaAMP daher mit heruntergeteilter Frequenz laufen lassen mⁿssen,
  116. k÷nnen Sie dies im Konfigurationsfenster einstellen. Sehen Sie sich unten
  117. stehende Tabelle zu diesem Thema an.
  118.  
  119. Es ist wichtig, da▀ der Frequenz-Regler auf der Frequenz steht, die
  120. tatsΣchlich am hΣufigsten benutzt wird. Wenn Sie zum Beispiel viele
  121. 44.1kHz Samples abspielen wollen und eine Frequenz-Teilung von 1:2 verwenden,
  122. sollte der Regler auch 22050 Hz stehen!
  123.  
  124. Wenn Sie nicht vorhaben, verschiedene Programme zur gleichen Zeit mit
  125. unterschiedlichen Wiedergabefrequenzen laufen zu lassen, k÷nnen Sie den
  126. Kanal-Regler auf der Position 1 stehen lassen. Die restlichen Einstellungen
  127. sind von Ihrer Audio Hardware abhΣngig.
  128.  
  129. WΣhlen Sie zum Abschluss der Konfiguration das "Save" Gadget links unten.
  130.  
  131. Nun ist es Zeit, AmigaAMP zu konfigurieren. Wenn Sie ein anderes AHI Unit
  132. als 0 gewΣhlt haben, sollten Sie den ToolType AHIUNIT im AmigaAMP Info-
  133. Fenster anpassen. Wenn Sie Unit 0 verwenden, starten Sie AmigaAMP einfach
  134. durch ein Doppelklick. WΣhlen Sie "Config" aus dem Menⁿ.
  135.  
  136. Stellen Sie die Regler und Checkmarks auf die von Ihnen gewⁿnschten Settings.
  137. Speichern Sie die Einstellungen und schlie▀en Sie das Konfigurations-
  138. Fenster.
  139.  
  140. Das war's auch schon! AmigaAMP ist damit komplett konfiguriert. Sie k÷nnen
  141. spΣter Feineinstellungen vornehmen. Die Performance des Systems hΣngt
  142. sehr von der Leistung der mpega.library und der Geschwindigkeit Ihres
  143. AHI Treibers fⁿr die verwendete Soundkarte ab.
  144.  
  145. Empfohlene Einstellungen (mit Prelude:Fast 16 bit stereo++ realtime getestet)
  146. -----------------------------------------------------------------------------
  147.  
  148.           |     Layer 1/2        |        Layer 3
  149. Prozessor | Quality|FreqDiv|Mono | Quality|FreqDiv|Mono
  150. ----------+--------+-------+-----+--------+-------+-----
  151. 68040-40  |  high  |  1:2  | off | medium |  1:2  | on 
  152. 68060-50  |  high  |  1:1  | off |  high  |  1:1  | off
  153. PPC604e   |  high  |  1:1  | off |  high  |  1:1  | off
  154.  
  155. Hinweis: Nur die 68k Version wird von diesen Einstellungen beeinflu▀t.
  156.  
  157.  
  158. Fortgeschrittene Konfiguration
  159. ------------------------------
  160. * Bufsize:
  161. Gr÷▀e des Lesepuffers. Am besten etwas probieren bis die besten Resultate
  162. erzielt werden. (Am besten ist normalerweise 16 bis 32K)
  163.  
  164. *TaskPri:
  165. Setzt die laufende TaskprioritΣt von AmigaAMP. Der Empfohlene Wert fⁿr
  166. unterbrechungsfreie Wiedergabe ist 1. Gott wei▀, was passiert, wenn
  167. irgendein Dritthersteller Task-Scheduler anfΣngt an AmigaAMPs internen
  168. Task-PrioritΣten herumzufummeln...
  169.  
  170. * Read ID3 TagInfo
  171. Versucht, Informationen ⁿber Interpret, Titel, etc. zu lesen. Da diese am
  172. Ende der Datei gespeichert werden, kann diese Funktion das laden etwas
  173. verlangsamen. Wenn diese Funktion ausgeschaltet ist, k÷nnen die
  174. Informationen weder geΣndert noch gespeichert werden!
  175.  
  176. * Allow multiple instances
  177. Normalerweise, wenn auf ein MPEG Datei Projekt-Icon geklickt wird wΣhrend
  178. AmigaAMP bereits eine andere Datei spielt, wird kein zweiter AmigaAMP Task
  179. gestartet, sondern der bereits laufende spielt die neue Datei. Dieses
  180. Verhalten kann abgeschaltet werden. Damit es reibungsfrei funktioniert,
  181. mu▀ AmigaAMP vorher zweimal manuell gestartet und bei eingeschaltetem
  182. "Allow multiple instances" jeweils die Konfiguration gespeichert werden.
  183.  
  184. * Limit volume to 0dB
  185. Der LautstΣrkeregler reicht von Stille bis +6dB so da▀ leisere Aufnahmen
  186. verstΣrkt werden k÷nnen. Um die LautstΣrke nicht aus versehen ⁿber Normal
  187. zu ziehen kann diese Option eingeschaltet werden.
  188.  
  189. * ToolType: DIRECTORY
  190. Dieses Verzeichnis wird standardmΣ▀ig im Dateirequester angezeigt.
  191.  
  192. Benutzung (wie man Sounds lΣdt und spielt)
  193. ------------------------------------------
  194.  
  195. Die meisten Funktionen von AmigaAMP sollten selbsterklΣrend sein, da sie
  196. sich in Σhnlicher Darstellung auf jedem CD Spieler wiederfinden.
  197. AmigaAMP verwendet jedoch natⁿrlich keine CDs sondern Dateien - es handelt
  198. sich schlie▀lich um ein Computerprogramm... Die Unterschiede in der
  199. Benutzung sind also wie folgt - die untere Reihe von Gadgets:
  200.  
  201.  - Eject      Stopt die Wiedergabe, l÷scht die derzeitige Spielliste
  202.               und ÷ffnet einen Filerequester, der die Auswahl eines
  203.               oder mehrerer neuer Samples erlaubt.
  204.  - Skip Back  springt zum vorherigen Track der Playliste zurⁿck - wenn
  205.               es einen solchen gibt.
  206.  - Stop       Stopt die Wiedergabe (was sonst?)
  207.  - Play       Startet die Wiedergabe, wenn mindestens ein File geladen
  208.               (und damit in der Playliste eingetragen) ist. Ist kein
  209.               File geladen (also z.B. beim Programmstart), wird ein
  210.               Filerequester ge÷ffnet und Sie k÷nnen ein oder mehrere
  211.               Files auswΣhlen.
  212.  - Skip Fwd   springt zum nΣchsten Track in der Playliste (zum nΣchsten
  213.               File, wenn Sie mehrere ge÷ffnet haben)
  214.  - Pause      Unterbricht die Wiedergabe zeitweilig, um sie spΣter an der
  215.               gleichen Stelle fortzusetzen
  216.  
  217.  
  218. ▄ber den Kontroll-Gadgets findet sich ein Positions-Regler. Wenn Sie
  219. ein File abspielen, k÷nnen Sie durch Verschieben dieses Reglers die
  220. momentane Abspielposition innerhalb des Files verΣndern.
  221.  
  222. ▄ber die WinAMP OberflΣche
  223. --------------------------
  224. Seit WinAMP 1.80 kann man eigene Texturen (sogenannte Skins) fⁿr die
  225. OberflΣche laden. Die Texturen bestehen aus mehreren Bitmap-Bildern die
  226. zusammen in einem Verzeichnis liegen. Sie enthalten das Aussehen des
  227. Abspielfensters und der Gadgets. Da mich mehr und mehr Leute darum bitten,
  228. AmigaAMP wie WinAMP aussehen zu lassen habe ich nun eine alternative GUI
  229. Routine eingebaut, die diese WinAMP Skins laden kann!
  230.  
  231. Die drei Varianten, die mir am besten gefallen habe ich AmigaAMP beigelegt.
  232. Sie befinden sich im "skins" Verzeichnis in folgenden Unterverzeichnissen:
  233.  
  234.  - base      -> Das original WinAMP Design
  235.  - sex       -> Ein ziemlich buntes, poppiges Aussehen
  236.  - eXquisite -> HolzgehΣuse und polierte Messingkn÷pfe :)
  237.  
  238. Um eines der neuen GUIs zu aktivieren mu▀ AmigaAMP mit den Optionen NewGUI
  239. und Skin=<Unterverzeichnisname> gestartet werden.  Falls einfach nur der
  240. normale WinAMP-Look gewⁿnscht wird, reicht "AmigaAMP NG" als Abkⁿrzung.
  241. Fⁿr die anderen Designs empfehle ich dringend die HighColor Darstellung
  242. einer Grafikkarte.
  243.  
  244. Obwohl die Bilder alle die Erweiterung .iff haben mⁿssen, k÷nnen sie in
  245. jedem beliebigen Format sein, fⁿr das ein funktionierender Datatype
  246. installiert ist (am besten durch laden in Multiview ⁿberprⁿfen). Mit einem
  247. geeigneten BMP Datatype lassen sich sogar die WinAMP skins 1:1 ⁿbernehmen.
  248. AmigaAMP versucht automatisch, Bilder mit den Erweiterungen iff oder bmp
  249. zu laden.
  250.  
  251. Zur Zeit funktionieren nicht alle Elemente der WinAMP OberflΣche. Es gibt
  252. z.B. kein Spektrogramm bei MP2 und auch keinen Equalizer. Der Shuffle-Knopf
  253. bewirkt auch (noch) nichts. Ansonsten lΣuft aber so gut wie alles!
  254.  
  255.  
  256. Rechtliches
  257. -----------
  258. AmigaAMP ist Freeware, das Copyright liegt beim Autor. Es darf frei kopiert
  259. werden, solange keine ─nderungen am Code oder der Dokumentation vorgenommen
  260. werden. Eine (vertretbare) Gebⁿhr zur Deckung der Kopierkosten darf erhoben
  261. werden.
  262.  
  263. AmigaAMP darf nicht fⁿr kommerzielle Zwecke verwendet werden, es darf auch
  264. nicht in kommerziellen Distribtutionen vertrieben werden, ohne da▀ hierfⁿr
  265. eine schriftliche EinverstΣndniserklΣrung des Autors vorliegt. Es darf
  266. nicht auf ftp- oder Webservern abgelegt werden, die kommerzielle Software
  267. oder Treiber fⁿr kommerzielle Hardware anbieten. Die einzige Ausnahme sind
  268. die Server des Aminet Archivs.
  269.  
  270. Es wird keine Verantwortung fⁿr SchΣden an Lautsprechern, VerstΣrkern,
  271. Amigas oder anderen Komponenten sowie Daten, die durch die Verwendung
  272. von AmigaAMP berⁿhrt werden k÷nnten, ⁿbernommen.
  273.  
  274. Obwohl ich ausgiebige Betatests vorgenommen habe, kann ich nicht garantieren,
  275. da▀ AmigaAMP unter allen UmstΣnden immer ⁿberall v÷llig problemlos
  276. funktioniert. Wenn Sie also Fehler oder Probleme entdecken, lassen Sie
  277. es mich bitte wissen.
  278.  
  279. Hier das originale Readme zu amp:
  280. ---------------------------------
  281. amp MPEG audio decoder readme file (version 0.7.5)
  282. (C) Tomislav Uzelac  1996,1997
  283.  
  284. amp is free software and can be _used_ freely by anyone. If you want to
  285. do anything else with it, be sure to check the Legal section of this
  286. document for legal issues.
  287.  
  288. THERE IS NO WARRANTY FOR THIS PROGRAM. Please check out the Legal section
  289. of this document.
  290.  
  291. 1. Introduction
  292. 2. Installation
  293. 3. Running
  294. 4. Feedback
  295. 5. Contributing
  296. 6. Legal
  297.  
  298.  
  299. 1. Introduction
  300.  
  301. amp (Audio Mpeg Player) is an MPEG audio decoder which I originally started 
  302. putting together as a side project of the MPEG hardware design project at 
  303. FER/Zagreb - just to confirm my knowledge of the standard. It works with
  304. both MPEG1 and MPEG2 audio streams (except for the multichannel extensions
  305. defined in MPEG2), layers 2 and 3. 
  306.  
  307. There is a gui for amp, written in Tcl/Tk by Edouard Lafargue. It is 
  308. available at the amp home site ftp://ftp.rasip.fer.hr
  309.  
  310. Another gui supported is the Sajber Jukebox, written by Joel Lindholm.
  311.  
  312. The following people contributed their time and knowledge to amp:
  313. Karl Anders Oygard, Ilkka Karvinen, Lutz Vieweg, Dan Nelson,
  314. Edouard Lafargue, Andrew Richards, George Colouris,
  315. Dmitry Boldyrev, Andy Lo A Foe, Thomas Sailer, Justin Frankel
  316.  
  317. amp home location is
  318.     ftp://ftp.rasip.fer.hr/pub/mpeg/
  319.  
  320. and the mailing list: send 'HELP' in the body of the message to:
  321.     multimedia@rasip.fer.hr
  322.  
  323. If you want to find out more about MPEG, best places to start are
  324.     http://www.mpeg.org
  325.     http://www.mpeg2.de 
  326.  
  327.  
  328. 2. Installation
  329.  
  330. Installation should be simple enough if amp was ported to your system,
  331. just do a 
  332.  
  333. ./configure
  334. make 
  335.  
  336. You can edit the makefile further to suit your system. If configure fails 
  337. to make a usable Makefile, you'll _have_ to edit it yourself.
  338.  
  339. Linux users should try real-time playing support, as described
  340. in doc/realtime.txt. Some people that might pass on this feature are
  341. those with slower machines (i.e. 486's), or SMP systems (see the
  342. doc/linuxrealtime.txt file). 
  343. Some versions of the linux C library produce an error when compiling
  344. amp with realtime support. A quick fix is to edit /usr/include/sched.h
  345. and replace _P in the offending line with __P.
  346.  
  347. ./configure --enable-realtime
  348. make
  349. chown root.root amp
  350. chmod u+s amp
  351.  
  352. ... this requires /dev/dsp to be both world readable and writeable. If you
  353. have a special group for people allowed to use the sound device (for
  354. instance, a group called sound), you can do a:
  355.  
  356. chmod g+s amp
  357.  
  358. or make your audio card world read/writeable (not recomended)
  359.  
  360. chmod o+rw /dev/dsp*
  361.  
  362. 3. Running:
  363.  
  364. 'amp -h' gives you usage & options. If your computer is on the slower
  365. side, direct playback might not work, but you can decode it
  366. to .wav or raw pcm and play it later.
  367.  
  368.  
  369. 4. Feedback
  370.  
  371. Send in your makefiles, opinions, bugreports, fixes; anything related to this
  372. program. You can also send me unlimited amounts of money, sugar, milk, etc.
  373.  
  374. If you find any mpeg audio files that amp has trouble decoding, please tell
  375. me about this via e-mail <tuzelac@rasip.fer.hr>.
  376.  
  377.  
  378. 5. Contributing
  379.  
  380. Please contribute to amp. If you want to know what is going on in amp 
  381. development, you can join the developers mailing list
  382.  
  383.     mpeg_audio_developers@rasip.fer.hr
  384.  
  385. There are certain debugging facilities that I made in amp, but are disabled
  386. in the current release (they are neither nice nor user-friendly). If anyone
  387. enhances them (they are in dump.c) to the point that they're actually
  388. usable I'll be happy to include the changes in the release. I think this
  389. kind of debug output would be very useful to people studying these audio
  390. algorithms.
  391.  
  392.  
  393. 6. Legal
  394.  
  395. This software can be used freely for any purpose. It can be distributed
  396. freely, as long as it is not sold commercially without permission from
  397. Tomislav Uzelac <tuzelac@rasip.fer.hr>. However, including this software
  398. on CD_ROMs containing other free software is explicitly permitted even 
  399. when a modest distribution fee is charged for the CD, as long as this
  400. software is not a primary selling argument for the CD.
  401.  
  402. Building derived versions of this software is permitted, as long as they
  403. are not sold commercially without permission from Tomislav Uzelac 
  404. <tuzelac@rasip.fer.hr>. Any derived versions must be clearly marked as
  405. such, and must be called by a name other than amp. Any derived versions
  406. must retain this copyright notice.
  407.  
  408. /* This license is itself copied from Tatu Ylonen's ssh package. It does 
  409.  * not mention being copyrighted itself :)
  410.  */
  411.  
  412. THERE IS NO WARRANTY FOR THIS PROGRAM - whatsoever. You use it entirely
  413. at your risk, and neither Tomislav Uzelac, nor FER will be liable for
  414. any damages that might occur to your computer, software, etc. in
  415. consequence of you using this freeware program.
  416.  
  417.  
  418. Tomislav Uzelac
  419. <tuzelac@rasip.fer.hr>
  420.